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S?5!i??^IS!5!' ^ defaults (for exaiple fiS-232 to PID), 

EXTENDED BASIC 3 changing the default baud rate of TEIl 

FORTH 7 froi 110/300 to 300/1200 and lanv 

JiflVARONE DB« 9 other changes lade directly to the 

TI ARTIST II 10 iodules' prograiiing (no load 

99 POTPOURRI 11 interrupt required). With the device, 

approxi lately 15 iodules can be saved 

depends on the aiount of leiory 

GRAM KRACKER*- present in the particular iodules, 

Mith Extended BASIC requiring 170 disk 

ERAH Kracker*-! sectors, while TI-*lriter can be saved 

our First ReoFt in only 34 sectors). Users can also 

Hrite additional code for a lodule or 

STANDARD! lA 9B ISA their own lodule by using TI's 

proprietary GPL language (user 

hillers Sraphics' SRAM Kracker'- 'iodules' could lake use of BASIC and 

(hiremafter rtferred to is "SK"), a Asseibly is itell), 6K coies nith 5iK 

niH hardiiare/softMarf package, Mas of battery backed up cartridge RAH and 

delivered to users as proiised shortly 6RftH, expandable to 8CK, and includes 

before Chriitiii. Our initial its otin lodule port for saving of 

reaction is that GK ii the lost iodules plus BK of pre-prograiiing for 

ekciting new product to coii along on-line saving, loading and editing of 

since the 99/4A itself. iodules and rooi for optional console 

SRAH's. The device allons a lenu nith 

GK coipletely opens the lori than one lodule on it, plugs into 

architecture of the 99/4A. For the the lodule port and is easy to install 

first tiie, 99/4A owners can lodify and operate. 

resident council GROH (operating 

systei and console BASIC). Hhile 

laking prograi changes to the council 

is certainly a project for experienced 

prograiiers, inforiation on such 

lodifications can easily be conveyed 

in an easy to iipleient fonat to 

aliost anyone Mho hat at lust liniial 

coiputer keyboard experiertft. (Notei 

Changes to the council and certain 

other operations require optional RAH 

at a cost of 113.50 U.S. and iiy also 

require leiory expansion and/or disk). 



Our first project Nith GK was, of 
course, to save all of our iodules to 
disk, thereby eliiinating tiorries of 
lodule failures. Additionally, we 
have noted a coiplete eliiination of 
the frequent systei lockups He were 
previously experiencing Hhile using 
iodules. The gold-pUted GROH port 
connector on the GK is a luch lore 
reliable connection than is available 
on iodules and the connector is easier 
to access for occassional cleaning. 



GK allows the user to back up any 
lodule (except the Hilton-Bradley HBX 
series, which have a luch lore coiplex 
architecture than other iodules) to 
disk, cassette, RAH disk or hard disk. 
Hodules can also be lodified, 
including changes such as changing the 
default colors, changing printer 



In order to leet their 
shipping schedule, Hillers 
departed froi their typical 
and released the device 
temporary lanual and utlli 
Though the laterial furnished 
the user started quite nicely 
Graphics offers assurances 



proiised 

Graphics 

procedure 

with a 

ty disk. 

does get 
, Hillers 

that the 
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final lanual and disk wiii be luch 
lore thorough. So, for now, we'll try 
to help everyone who already has a GK 
get started. GK was designed for 
systei and lodule exploration and a 
lot of inforiation on iodules has 
already coie to light! Though GK is 
easy to use, iodules coie in a variety 
of "flavors', so, for those who have 

or soon will have a GK, we'll take a 
look at soie of the peculiarities of 

how the iodules work and how to handle 
the variety of available nodules froi 
the GK environient. 

TEII 

The GK lanual describes changes 
to the TEII lodule froi 110/300 to 
300/1200 baud. Mhile the instructions 
worked fine for our TEII, not all of 
the TE H's were the saie! (Note: Soie 
iodules saved soie files as D/F 80, 
while the lore coiion iodules save all 
text files as D/V 80. Soie iodules 
were labeled TEII, while others Mere 
labeled TE2. Also, soie differences 
have been noted in the way different 
versions output to printer,), If you 
are unable to find the neiory contents 
as described in the lanual, try a 
search beginning about 20 bytes before 
the address suggested in the lanual 
(Howie Rosenberg reports finding the 
values described as being at g6F4iG at 
g6F38, for exaiple. However, the 
nuiber of bytes off froi the lanual 
exaiple floats, so you lust search 
each address individually.). When 
doing a search, be sure to follow the 
lanual's instructions carefully, 
placing your cursor on the last 
character in the search string (not 
one character beyond I ) . Also, in 
order to access speech eianating froi 

a TIBBS'- BBS, the Loader lust be Off 
while using the TEII lodule (He have 
found no way to access speech 
eianating froi a TIBBS** at 1200 baud, 
so the lack of speech at 1200 is not 

— > 



relatid to &K. The SfEAt( coiiand, 
<CTRL> <1>, NiU Hork Hith the Loader 
On or Off.). The Loader OH is 

required to receive TIBBS^' speech due 
to the speech routine using a BASIC 
PAB (see the BASIC lodules section 
Del oh). 

Auto Execute Modules 

rtodules that auto execute) such 

as Plato^-, (to not alloH access to a 
poHer-up iinu froi Mhich GK could tie 

iilected (except, H you have a 
CorCoip Disk Controller, that 

controller ilHays takes control on 
potter-up and does therefore provide a 
proper lenu). Millers Graphics, upon 
Piing questioned about this latter, 
created a fix Nithin hours and hHI 
provide the inforiation in the final 
lanual. The fix is a 3 byte patch to 
aRAH (a 'console' GRAH). 

RAH hodules 

To use Mini Heiory, the lodule 
should be saved and loaded as norial, 
except that, after loading, the 
tIrits/Protect switch on GK should be 
SNitchcd to Bank 1 to allOM use of 
m, as m is available froi the 
iodule. The 'N/P' environient is the 
norial environient for nearly all 
lodulis, Nlth the exceptions being 
Mini Neiory and liiicking a 'Super 
Cart' (by loading E/A and enabling 
Bank 1). 

Bank-SMapped Hodules 

Bank-SHapped lodules, such as 
Extended BASIC and soie of the Atari 
lodules (Pole Position'* is one), lust 
be operated in strict accordance Hith 
GK instructions. That is, the 
Nrite/Protect switch lust be on '*/?'. 
The bank swapping is perforied by 
'Mriting' to ROH (you can't actually 
write to RON), so if you enable Bank 1 
or Bank 2, an actual write will occur, 
no swap will occur and you won't get 
very far! 

BASIC Hodulis 

A few lodules are written in 
BASIC or both GPL and BASIC and 
therefore require that the Loader 
switch be in the Loader Off position, 
unlike the Loader On that is 
ricoiiinded for other lodules. The 
BASIC lodules include Personal Record 
Keeping, Securities Analysis, 
Statistics and Personal Report 
Generator. There lay be other lodules 
in this category. 



Early LOGO Learning fun 

The Early L060 Learning Fun 

loduU is not coipatible with the 
CorCoip Disk Controller. The problei 
is that the aodule has an Application 
Prograi naie length of >00. Mhen the 
CorCoip DSR goes through the iodule 
looking for Application naies for the 
lenu it starts lovlng thei out and 
then it decreients the naie length 

counter. >00 decreiented is >FF or 
253 bytes, which causes a less on the 

title screen (naies can't be that 
long) . To correct this, SAVE the 
iodule to disk using cassette with the 
P.E.B. off or use a TI or HYARC disk 
controller and then LOAD it back into 
the GK. Select the GK's Heiory Editor 
and change the byte at g6047 to >01 
and resave the iodule. 

tut 

The Utilities disk instructions 
lention using the file CHARAl, but 
that file exists in its original fori 
froi Tl, an update froi TI and several 
iipleientations froi various 

prograuers. Because only one of the 
versions was intended to work and so 
•any versions exist, Killers Graphics 
will be releasing a coipletily new 
character set on the final Utilities 
disk. 

For the file XBCALLS, the CALL 

CLSALL (to dose all open files) was 

Oiitted froi the teiporary disk (a few 

disks included a non-functioning 

version) and will appear on the final 

disk. Other CALL'S will also be 

available, including a CALL CAT to 

catalog any disk (floppy. RAH or hard 
disks) froi iiperative loae. You lay 

want to lake note that the CALL'S load 

into address gDSOO. CALL NEN, CALL 

BVE, CALL CLOCK and CALL CLKOFF work 

froi either iiperative (iiiediate) 

iode or froi within a prograi, but you 

lUst also do a CALL 

LINKCSETCLK', '000000'} to actuate the 

interrupt driven CALL CLOCK routine. 

■000000' can be set to the current 

tiie or used as an elapsed tiaer. The 

clock appears at the upper right 

corner of the screen (not the left 

corner as stated in the instructions). 

As the routines are not in Low Heiory, 

CALL INIT does not affect the clock. 

Ne do not recoiiend loading 
lodules through the HYARC HEXP-1 RAH 
Disk. Doing so soietiics yields a 
iodule that does not function 
properly. Speculation is that RESET 
froi either GK or a Navarone Cartridge 
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Expander'* affects randoi bytes on the 
RAH Disk, but no definite inforiation 

is available as to Hhy the files do 

not load properly, only that they 

don't. One certainty is that this 

problei has been noted outside of the 
8K environient. 

Another note on using the HEKP-l 
card froi HVARC is that when in the GK 
Editor, spooling print goes to the 

NEKP-l buffer, but does not print 

until the GK Editor has been exited. 

Any tiie interrupts are disabled, as 
in the GK Editor, the spooler pauses. 

Hell, we've tried to answer lost 

of the questions that have surfaced so 
far on CIS, BBS's and through Killers 
Graphics. Hodifications for soie of 
the iodule peculiarities will likely 
be found on the TI FQRUH on CIS before 
release of the final disk, Users have 
been so eager to learn about the 
powers of GK that the TI FDRUH has 
titled Section 4 as Kracker Hackers, 
for the exlusive use of GK owners. If 
you have questions, Craig and Sue 
Hiller at Hillers Graphics are always 
eager to offer full support for their 
products, so be sure to contact thei 
so you'll be sure to be happy with 
your GK! 



6RQH Hodificationsi Tips froi 
Hillers Graphics 

STANDARD! lA 9B ISA 

Thanks to Craig Hiller of Hillers 
Graphics for granting us pertission to 

print the following lodifications, 
which were uploaded to CIS by Hillers 

Graphics. 

It Extended BASIC CALL INIT correction 

Presently, the CALL INIT loads 
)600 bytes starting at >2000 in Low 
Expansion neiory, but only >4F3 bytes 
need to be loved. Because of this, 
soil routines that were loaded /into 
Low Expansion Heiory get overwritten. 
The patch corrects this situation. 

1) Kith Extended BASIC loaded into GK, 
select 5 (Heiory Editor) froi the GK 
Henu. 

2) Press FCTN « HEX, FCTN 1 for GRAH 
Heiory Window and the FCTN 5 for 
SEARCH (e^.i Ukm is a retll^ 
potitrftil ml!) 

— > 



-^■?. 



J& 



r 



Vi Type in UOO for tne START addreis 
and cm ior the FINISH addrm. 
Press FCTN 9 to put the cursor in the 
Search String Input field and type in 
31 06 00. Press FCTN S (left arroH) 
to place the cursor on top of the last 
byte to search for and press enter. 

4) Turn off tirite Protection, press 
FCTN 5 to leave SEARCH and press FCTN 
9 to put the cursor in the Meiory 
HindoH. NoM replace 31 06 00 with 31 
04 F3. 

5) Restore Write Protect, return to BK 
lenu and resave the lodule. 



6) CALL I^T Mill 
quiclter and it 
unneccessary bytes 
Expansion. 



noH Hork a littli 
Hill not love 
out to LoH Neaory 



SLASHING THE ZERO IN AN ALTERNATE 
OPERATINS SySTEN 

This ■odification requires an 80K SK 

Nith &RON 0, the TI Operating Systei, 

copied into GRAH so it can be 
■odified. 

n With an Alternate Operating Systei 
loaded into the Optional BRAN (SOK 
GK), turn on BRAH and select BK froi 
the lenu. 



2) Select 5 (Heeory Editor! froi the 
SK Henu. Press FCTN ■ for hex, FCTN 1 
for GRAH Heiory and then press FCTN S 
(SEARCH). 

3) Type in 0000 for START address and 
1000 for the FINISH address. Press 
FCTN 9 to place the cursor in the 
Search String Input area and type in 
00 38 44 44 44 44 44 3B and then press 
FCTN S (left arroK) to put the cursor 
on the last byte to search for and 
press enter. 

4) For lost Operating Systeis the hex 

string Mill be found at >0723. Nom 
press FCTN 5 to leave SEARCH and then 
press FCTN 9 to put the cursor in the 

leeory HindoN. Turn off Write 
Protection and type in the following 
bytes to change the zero; 00 3B 44 4C 
54 64 44 38. 

51 NoH turn on Write Protection, press 
CTRL " to leave the Neiory Editor and 
then resave the lodified Operating 
System (Bi^AM 0), 

Extended BASIC Auto-Boot (DSKl.LOAD) 



Bypass Patch 

1) Load Extended BASIC into the EK. 

2) Froi the GK Menu, select 5 (Neiory 
Editor). Then press FCTN « for hex, 
FCTN 1 for the GRAH Heiory NindoM and 
then press FCTN S for SEARCH. 

3) Type in >6300 for the START address 
and >640O for the FINISH address. 
Press FCTN 9 to put the cursor in the 
Search String Input area and type in 
S6 A3 71 and then press FCTN S (left 
arroN) to put the cursor on the last 
byte to search for. Next press ENTER 
to start the Search. 

4] For lost Extended BASIC lodulis the 
hex string Mill be found at >b3CD. 
We'll call that "address A". Non 

press FCTN 5 to leave SEARCH and then 
press FCTN 9 to put the cursor in the 
Meiory MindoH. Turn off the Write 
Protect (turn it to Bank 1). Nom 
change the first two bytes (86 A3) to 
5B 00. This is a BRANCH ON RESET to 
>7600 instruction. 

5) Press FCTN 9 and change the Neiory 
WindOM to g7800. You Mill see garbage 
here (unless you have previously put 
soiething in this spacel!). The 
GRQH's are only 6K in length, so the 
bytes in the last 2K are 'garbage Mrap 
around" read by the GK Save routine. 
So, it's a good area for adding 
routines to your lodule. 

6) Press FCTN 9 to put the cursor in 

the Neiory WindoM and at the g7800 
leiory location, put in the folloMing 
code] 



86 A3 71 


CLR ve>371 Clear Auto Load 




needed flag 


03 


SCAN Scan the keyboard 


D6 75 20 


CEfl >20,e>e375 




Is the Space Bar 




pressed? 


CNoM take 


your 'address A" and add 6 


to it] 




O63C0 + 


6 = >63D3] 


63D3 


BS 'address A' plus 




6 bytes. Yes! 




(Branch on -Set) 



[Take your 'address A", add 3 to it 
and replace the first digit with 4] 

[>63CD * 3 " >63D0 change it to 

43D0] 



43D0 



BR 



'address A* plus 
3 bytes. No! 
(Branch on Reset) 



7) For a lodule with a /oK'u "address 
A' your Meiory Window should noti look 
like thisi 

g7BO0 



B6 A3 71 03 1)6 75 20 63 D3 43 DO u 
XX XX XX XX XX XX n n n xx xx xx 

XX - don't care 

8) Nom restore the Write Protect, 
return to GK Menu and resave your 
lodule. 

9) NoH Mhen you select Extended BASIC, 
you can bypass the auto-load coBoand 
by holding down the space barl (No 
lore DSKl.LOAD search) 

The above lodifications by D.C. 
Warren (Nillers Graphics prograiier) 
represent only the 'tip of the 
iceberg'! An entirely neM Morld of 
prograiiing has now been opened to 
99/4A owners. While Me feel that the 
99/4A council and lodules have served 
us Hell for a long tiie, luch of the 
code was Mritten over six years ago! 
Many great ideas have coie down the 
pike during these years, but noM, for 
the first tiie, He actually have the 
leans to change the original code. 
With GK, 19B6 Mill surely be the lost 
exciting year ever for 99/4A OMners! 
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EXTENDED BASIC 

Linking Asseiblv to Extended 
BASIC " A Tutorial for Beginners 

STANDARD: lA in EA 4B 5A 6B 7B 9A 

A couple of lonths ago one of our 

I Wish I Had requests Has for a May to 

siiply build a screen that Mould 

display quickly. Our suggestion was 

to use a prograi called NENGEN, 

available on the CIS TI FQRUN. While 

NENGEN is a very useful tool, its use 

assuies having a screen already 

displayed and the data stored includes 

lore than just text (colors, etc.). 

Another excellent screen builder 

prograi we've seen is Barry Traver's 

DISPLAY/AT prograi. DISPLAY/AT offers 

the advantage of using Tl-Writer to do 

full screen editing of text, 

generating a prograi with DISPLAY AT's 

(hence the naie) in MERGE foriat. We 

decided to coibine the basic ideas of 

HEN&EN and DISPLAV/AT and detail what 

we are doing in our Asseably Language 

— > 



program for the benefit of th 
Extended BASIC to Assembly. 






ose who are new to Assembly and/or to linking 



Assembly. 
Language! 
fully ann 



h 
No 
For 



We ve heard from many of you that you have no interest in learning 

problem! Our program requires almost no knowledge of Assembly 
those who do want to understand what we are doing, the program is 
ed in hopes you will completely understand the process. 



The program that follows will allow you to 
on a simulated Extended BASIC "screen" (the area 
32 characters wide by 24 lines long) from the 
only other information that you must understand 
called START and the label START must be changed 
to siK characters long) to enable you to load se 
at once (labels and DEF's must match for each sc 
intended primarily for beginners, it uses a fa 
Assembly and is offered for its simplicity of 
only method of coding and we don't claim it to b 
programmers. 



move your cursor around freely 
within the single quote marks, 
Ed i tor / Assembl er Ed i tor . The 
is that the DEF that we have 
to whatever you would like (up 
al screens into Low Memory 
n used). As this program is 
irly traditional approach to 
It is certainly not the 
e the best method for advanced 



f 






DEF START 



VSBW EQU >2020 



GPLWS EQU >83E0 



STATUS EQU >B37C 



SAVll BBS 2 



MYWS BBS >20 



START MOV R 1 1 , es AV 1 1 



LWPI 
LI 

» 

LI 
LI 
BL 
RETURN LWPI 

« 

« 

« 

MOV 
CLR 



MYWS 
R0,0 

R2,L1 
R3,768 
eWRITE 
GPLWS 



QSAVU,R11 
aSTATUS 



WRITE 
* 

» 

« 



RT 
MOVB 



«R2+,R1 



CHANGE 'START' HERE AND BELOW AS DESIRED— 
DEF IS STORED IN THE DEF TABLE AND IS 
REQUIRED TO LINK FROM EXTENDED BASIC 
POINTER TO UTILITY WORKSPACE FOR VIDEO 
SINGLE BYTE WRITE. NOW VSBW EQUATES (IS 
ANOTHER NAME FOR) >2020 

THE WORKSPACE FOR GPL IS ALWAYS AT >83E0 
NOW GPLWS EQUATES TO >83E0 
THE GPL STATUS BYTE IS ALWAYS AT >837C 
NOW STATUS EQUATES TO >B37C 

THE BLOCK STARTING SPACE RESERVES 2 BYTES 
FOR OUR SAVING OF REGISTER H, WHICH 
TELLS BASIC WHERE TO RETURN TO 
OUR WORKSPACE WILL BE 32 BYTES LONG (2 
BYTES PER REGISTER X 16 REGISTERS) 
(32=>20). REGISTERS ARE MEMORY WORDS 
THAT SERVE A SPECIFIC PURPOSE. 
GENERALLY, IN ORDER TO ACT UPON A VALUE 
(SUCH AS TO ADD), THE VALUE MUST BE IN OR 
PASSED TO OR THROUGH A REGISTER. 
REGISTERS ARE ALSO FREQUENTLY USED TO 
REFERENCE ADDRESSES, EITHER DIRECTLY OR 
INDIRECTLY, 

CHANGE 'START' AS DESIRED 

STORE THE VALUE IN REGISTER 11 SO WE CAN 

RETURN TO BASIC PROPERLY 

LOAD OUR WORKSPACE POINTER AT MYWS 

OUR BEGINNING SCREEN POSITION WILL BE 0, 

THE UPPER LEFT CORNER OF THE SCREEN 

WE'LL WRITE WHAT'S AT LABEL LI 

WE'LL WRITE 768 BYTES (ENTIRE SCREEN) 

BRANCH AND LINK TO ROUTINE 'WRITE' 

(NOTE I LABEL 'RETURN' NOT REQUIRED) 
PREVIOUS REGISTER VALUES WILL NOT BE 
IN USE, WE'RE MOVING TO A NEW 
WORKSPACE AFTER RETURNING FROM 'WRITE' 
RETRIEVE THE RETURN TO BASIC POINTER 
CLEAR THE STATUS BYTE TO 
CLEAR ERRORS UPON RETURN TO BASIC 
RETURN TO BASIC 

MOVE THE CONTENTS OF THE HIGH 

BYTE OF REGISTER 2 (ON THE 1ST 
PASS IT IS THE FIRST CHARACTER AT 
'LI') TO REGISTER 1 AND 
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-> 



» 
« 

« 



« 

« 



LI 



AX 



Ri, >6000 



BLMP @VSBW 



INC RO 



DEC R3 



JNE WRITE 



RT 



TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
END 



9 
P 

r 

9 

r 

9 
9 

9 

9 

9 

9 

9 

9 

9 

9 

9 

9 

9 

9 

9 

9 



ME ARE 



INCREMENT R2 BY ONE (BYTE 

INSTRUCTIONS INCREMENT BY 1, 

WORD INSTRUCTIONS P ' 7' 

ADD >6000 TO THE VHi-Ub. IN Rl 

WE'RE WORKING WITH BYTES, SO 

FUNCTIONALLY ADDING >60 TO THE HIGH BYTE 

OF Rl. IN LINKING TO BASIC AN OFFSET 

OF >60 (DECIMAL 96) BETWEEN MEMORY AND 

VDP MEMORY IS REQUIRED- 

BRANCH AND LOAD THE WORKSPACE 

POINTER AT THE VIDEO SINGLE 

BYTE WRITE ROUTINE 

VSBW USES REGISTER AS THE ADDRESS IN 

VDP AND THE MOST SIGNIFICANT BYTE OF 

REGISTER 1 FROM MYWS AS THE VALUE TO BE 

WRITTEN 

INCREMENT REGISTER TO THE 
NEXT SCREEN POSITION 
DECREMENT THE BYTE COUNTER 
IN REGISTER 3 SO WE'LL KNOW 
WHEN 768 BYTES HAVE BEEN WRITTEN 
IF ALL 768 BYTES HAVE NOT BEEN 
WRITTEN, JUMP TO 'WRITE' 
RETURN TO THE INSTRUCTION 
FOLLOWING WHERE WE BRANCHED FROM 



YOUR EXTENDED 
BASIC SCREEN 
WILL DISPLAY 
THE CHARACTERS 
YOU PUT WITHIN 
THE SINGLE 
QUOTE MARKS 
< 



TELLS THE ASSEMBLi£R WHERE OUR CODE ENDS 



Now, the above routine must be entered in the Editor/Assembler Editor. 
Our comments (remarks on the right and lines that begin with an asterisk) are 
not required. The above routine is Source code. It must be saved to disk 
(ending your -file name with "/S" will remind you that the -file is a Source 
-file). Use the Assembler to Assemble the -file to Object code (end the -file 
name with "/O"). The Assembler will check -for Syntax-type errors- I-f no such 
errors have been keyed in, the Assembler will report O errors. I-f you have 
keyed the program in wrong, errors may be reported, but the absence o-f reported 
errors only means that the Assembler -found your program syntactically correct. 
For instance, keying ">8000" instead o-f ">6000" will not produce code that 
works, but will also not generate an Assembler error! 



Once the program is Assembled, it is ready to be linked to Extended BASIC. 

— > 
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up 
load 
link 



Low 

the 

to 



Tha -following line will 
Memory -for code (CALL INIT) , 
Object -file <CALL LOAD) and 
the code (CALL LINK): 

100 CALL INIT :: CALL LOADC 
DSK1.SCREEN/S"):i CALL LINK( 
"START") 



In some situations, you may -find it 
advantageous to place the INIT and 
LOAD in a separate program and RUN the 
main program -from the LOAD program, so 
that i-f you break the main program you 
i^ill not need to LOAD the object -file 
again to RUN the program again. The 
code will remain in memory until you 
power o-ff the memory card (-for TI 
equipment, powering of-f the expansion 
box clears the memory card). Or, your 
program will no longer recognize your 
routines and memory will be available 
-for loading more routines if you do 



another 
than one 
time, 

LOAD'ing 

point in 
display the 
CALL LINK, 



CALL INIT. 
program in 



If you want more 

memory at one 

CALL INIT only before 

the first program. At any 

your program that you want to 

screen , si mpl y use the 

Remember, the LINK is to 

point, so be 



your DEF and the entry 
sure those three match! 

Now, why do all of the above? 
The displays are extremely fast. 
However, there is a trade-off. The 
LOAD time for the routines is very 
long unless you combine your A/L code 
with your Extended BASIC program and 
save it as one file (refer to Barry 
Traver's diskazine for a way to do 
that — it's beyond the scope of this 
article). So, unless timing is 
critical (such as for games) or you 
will be usi ng the same screens 
repeatedly. Extended BASIC'S slow 
Loader will not be a good trade-off 
for the time you save in displaying 
the screens (unless you are in the 
habit of eating a sandwich while a 
program loads). However, there are 
some other advantages to using the 
program. 

In using Assembly Language to 
display screens, the code for the 
displays loads into Low Memory, while 
your Extended BASIC program can only 



reside in High Memory. You are left 
with far more room for your Extended 
BASIC program! You'll cut >your code 
from numerous DISPLAY AT's to only one 
CALL LINK! Not only will you have more 
room for other Extended BASIC code, 
but your Extended BASIC program will 
also appear less cluttered! It's great 
for program instructions I Finally, by 
using the Assembly program above, you 
will be able to create your screen 
using a full screen editor (just move 
the cursor around freely with the 
arrow keys) ! 

We hope you'll find this 
introduction to linking Assembly to 
Extended BASIC useful. We'll try to 
answer questions you might have and 
then assume you fol lowed this article 
well enough to move on to more 
advanced projects. 



Chaining Programs! 
Some Suggestions 



STANDARD I lA 2XB 4B 5A 6B 7B (o) 9A 



One 
programmi 
program 
should be 
to the ex 
practice, 
is so wid 
BASIC, th 
fundament 
character 
the state 
end of a 
"garbage" 
chained t 
line that 
the drive 
of the pr 
an END) . 



of the elementary rules of 

ng is that, upon leaving a 

environment, the computer 

in the same state as prior 

ecution of the program. In 

perhaps no other convention 

ely disregarded. In Extended 

e most common break from this 

al approach is In leaving the 

patterns and color sets in 

that happens to occur at the 

program, thereby providing 

screens for any program 

o the program (via a program 

uses RUN DSKx.y, where x is 

number and y is the filename 

ogram to follow, in place of 



Of course, debugging another 
programmer's work is often a^ nightmare 
situation. An effort to go through 
hundreds of programs on dozens of 
disks to restore the color 
character patterns woul d 
certainly be a cumbersome, 
vain, project. But, there is 
simple solution. 



and 

almost 

if not 

rather 

— > 



) 



) 
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Rathar th^n chain direri-i w *-« »»»^i. 
program prov.deB the Cpp^rtun ty to reJurn^CnP*':"^'^^' ^^^^"^^9 to a i 
previous program ^nvirbnm.nt The cnd^ ^^ h *'° '*^f "°'^'"*^ =**t= outside the 
CHARSET HiU restore the patterns%on^K^^ ^? *° ^2"^^ ''^ ^•'^V simple. A cllL 
143 could easily restore the remainder 2r?^^^ A loop from 96 to 

the normal charicter patterns? a cSllcSarpS? ^^^'^^^ters. Of course, to obtain 
codes that initially %xist And a cS^L cSIr '^«^E?"^^k'' "4i^ "^^^^^^ ^^^ hex 
interacting with DATA statements containinn th« hI! '" .^^^ ^^ *° ^"^^ 1°°P' 
patterns, A loop of 1 = 1 to 12 with CALL Mi dSTt ? i ^ "^^^ restore ^hL 
sets- And, a CALL SCREEN(8) win'^^^^IZe^?};^ ^^;i^;;l>^-i^_ --tore th 

charac?;rr??:mV?^ 143."?iS:rc::b"lo^?:ar':^: ^t '^^ 1" ^^^ ^^^ ^- the 
routine. The address is f i ger cCb So??war e ?5A"''?„f?^ ^"^^S '^°- ^ ^^^ «"'=h a 

OH 43213, 1+ you write and enclosr«rvAuMf^S"^"??'' ^^°- ' Columbus, 
Just in case «nm«««- ^ , if ^__;^ . . *^' Y^" ^^ receive the latest ra+ai«r. 



restore th 

color 



Just in case someone doesn't know Twheri h-^« C ^"^Xf *^^ ^^^est catalog 

Jim Peterson, a truly Sedicated and hSnLt^^^ i= -^"n ^Y 

tips free to over 100 user groups' Whfr«nn?hr: ^*'=h month, Jim sends out 

Bolts, Tigercub has now released Nuts inn S„l^ J' m°'''o °* ^igercub and Nuts and 
than the first disk of "Ex?i":f baSI? SubproJrLs?" ^' "^'^^ '^ ^^*" ^^"-"^ 



An Array of strin 
by Warren Agee 



also s?rLseS%;:: Tmp;rta^°:%rthrcoSnt"E^i: I'S h'*n^ ^^^^"« ^" '°^''^- ' 
the string. Now, we have gradSated to the reafm of «?"■ ^° '"°''*' ^^ ^^°"9 with 
entirely new mess with which to work? string arrays, which is an 

bytesI'oJ'a^^trinrs?? seq^rn^ratw^^rmeSo^v^'^i"^; S^"" ^^^ character <or 
elements in a string arri? dC a?so But thill. J ^ ^^^"?* ^° '^^^=°" that the 
be forced by the programmer; main^iinina^n l^tV^^ structure of an array must 
The structure is what we wUl diScSsS ?irs?, ^ '* "°* automatically done. 

Here is a possible string arrays 



!3J^CIAIT! i3IDI0(GI ! i 14 IBi I IRl DI5IP tO IOJCJhT 



i^': :«:r E^h^re:::?'?;; ^?r; arr;y^,i:^/s'f:°°*="; r^"»' ^^^^^-^ ^- -vi This 

bytes, #2 has 7, #3 ha, 5? anS #5^*2 2 Hnw Jn ?k""^ length. Element #1 has 5 
track of all this? You cannot- E*^meAt^ iA 1 T"""^"* ^"^^ ^°" «°^"9 to keep 
constant length, A much better' ' wa^^:rC^n'st?Cct%hr:£S?e l^Z iT^.J"^..^ 



#3IC^AITJ ( #3iDm(G7 7 i47B7l7R7Dr;i5ip7oiOICIH 



( 
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length. If th 
BKcess space. 



string is shorter than the maximum, then blanks will fill the 



So much for structure and theory. How do we go about achieving this n 
and tidy array? Well, start out with good ol ' VARIABLE. Remember, arrays 
(string OR numeric) are just stretched-out variables. Think of a good name, 
let's say PETS. Now, decide how many elements this array is going to contain. 
Let's say 20, Now decide the maximum length of the elements. Let's keep it at 
6. Remember to allow enough room for the count byte for each element! This 
sequence will then create our arrayi 



VARIABLE PETS 
60 ALLOT 



(10 elements X 6 bytes each) 



That's it! Easy, eh? Actually, you can think of the 60 ALLOT as a DIM statement 
in BASIC. It reserves memory for the array. The hard part is accessing the 
individual elements. Also notice that I totally ignored the initial two bytes 
which VARIABLE automatically reserves) when dealing with large arrays, the 
first two bytes are insignificant and may be ignored. This makes for much 
better readability when going over your program listings. 

Now refer back to my diagram of the PETS array. The first box of the array 
is the address provided by PETS. Since the first element has a count byte, 
simply typing in PETS COUNT TYPE will print out "CAT". But how do you get at 
the rest of the array? You have to calculate the address of the element, using 
this simple formulai 

base addr -*- (element # « length of each element) 



0, 



The base addr is PETS. Now, as with most of FORTH, element numbers 

zero. Let's say you want the first element using this formula. Plug 

values: base addr=TEST, element #-0, length»6. 6*0- 

to the base addr to find the first element- That makes 

to the second element, the sequence to type in is (TEST 1 

actually doing is adding an offset to the base address. 

address of the element, a simple COUNT TYPE will print 

you stored the count byte! If you want to view all th 

ins 



in the 
so you Are adding O 

se! Similarly, to get 

6 * -»■). What you are 

Once you have the 

the contents, providing 

elements in PETS, type 



I GO 10 O DO CR PETS I 6 « + COUNT TYPE LOOP ; 

Since element #s start at zero, we want to print out elements 0-9- However, 
you must always add 1 to the upper limit whenever using DO LOOPs in FORTH. 

As you can imagine, if you have a lot of string arrays, you will need to 
make these calculations often. To make it more readible (and more convenient), 
we can easily turn that into a definition, as followsi 

I PETSO PETS SWAP 6 « + ; 



: GO 10 DO CR I PETSO COUNT TYPE ; 

This is MUCH easier to read than before. As 
symbol to indicate that PETS is an "indexing 
stack is the index, or element #. A word of 
LOOPS, the word "I" must used in the - same 
You cannot put the "I" in the definition of 
definition as the DO LOOP. This problem is 
Since we removed the "I" from PETSO, we 
of the loop. In other words, if all I needed 
I could just type in 9 PETSO COUNT TYPE. No 



a naming convention, I use the O 
" words all it requires on the 

warni ng : When you are usi ng DO 
- definition as the loop itself. 
PETSO I it MUST appear in the same 

tual 1 y a b 1 essi ng in d i sgui se. 

free to use the Index word outside 

was the last element of the array, 

loop is needed! 



mi 



Up till now, all you have done is sit b 
babble on about accessing an array. Here' 
I show you how to store things in your 



ck with your 
your chance 
array- First 
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arms folded and watch 

to follow along with 

we will use ACCEPT 

— > 



I 



and input the strings directly into the dictionary, then 
routine so «e -first input into PAD. First o-f all, we 
ba*.. In tha abov« vxampla, POOCH barely -fit into the 
characters. If we are to use ACCEPT (which wa- 
tutorial) and input directly into the array, we n 
tor each element. You see, ACCEPT 
o-f each string. So if you input a 
into PETS, ACCEPT will over-write 



mind, here is the complete routine: 



we will mod 
have to modify our 

space allot for 
defineJ in the 
to tack on 2 mor 
(and EXPECT) always glue 2 nulls onto 
string exactly 6 characters long 
the next element with nulls! With 



ify our 

array a 

it — 6 

previous 

e bytes 

the end 

directly 

this in 



O VARIABLE PETS 

80 ALLOT 

PETS 80 BLANKS 

() PETS SWAP 8 « + 



(10 items « (6+2) bytes each) 



() 



( 
len 



addr of 
for each 



INPUT- IT 

10 O DO I 

6 ACCEPT ( max 

LOOP ; 

PRINT-IT 

10 DO I PETSO COUNT TYPE 
LOOP : 



h element) 
string=6) 



m-^K-i!^I°"x^fu* ^'T*" *°llowin3 «ince the first installment in this 
mechanics of this loop are self-explanatory. 



series, the 



into 
into 
(remi 



Thi 
the 
PAD 
mb 



is fine, but remember what I said about 
array? To avoid those darn blanks from cr 
first, then move them into the array. 

to FORGET PETS first): ^ 



avoiding inputting directly 

eeping in, Input the string 

Here i s the new rout i ne 



t 
: 



VARIABLE PETS 60 ALLOT 

60 BLANKS 
PETSO PETS SWAP 8 « + ; 
INPUT- IT 

10 DO PAD 6 ACCEPT 
PAD COUNT 1+ SWAP 1- SWAP 
I PETSO 
SWAP 

CnOVE« LOOP 



(10 items + 6 bytes) 



PRINT-IT 

10 O DO CR I PETSO 



(Get addr of element #1) 

( source addr,dest- addr, cnt) 

CMOVE* was defined in the previous) 
tutorial ) 



COUNT TYPE LOOP 



4...4.„^7 ? COUNT 1+ ... sequence seems confusing, but if you read mv last 
^«?^^«^ S^i ^°" should remember it. We want to move not only the string, but the 
^?««« ^'^}^ ^f well. But PAD COUNT returns the address of thi string itself 
along with its length- Subtracting 1 backs up the addr to the cSSnt bvtei 
meanwhile, add 1 to the cnt on the stack so CMOVE* will move the entire 
e?:i.2S:'=?*'^?^=° '^='"«'"ber that I PETSO just returns the proper addresS or ihS 
7l^3«"t jn the array^ f ^'"^^^^^'^ sequence in BASIC would^ bS FOR I^! TO 10 :f 



Well, I've run out of 
string array utility words 
processing! Bye for now! 



room for this issue. Next time I will introduce some 
Which will allow you to do some heavy-duty string 



NAV/AF=%C]M 



Switching Betwe en Single and Dual Disk Drive Svst 



ems 



STANDARD: lA 2DB 3B (o) 4B 5A 6B 7B 9B lOB (o) 



In many ways, we've 
really great- It is fast 
is not very good)- But, 
and we'll take a look at 



found the 

and uses 

there are 

a fix for 



Navarone Database Management package to „= 
a minimum of keystrokes (though the "manual" 
some serious problems that one can encounter 
one in this article. 



wor 



d5^®thi'sS?Mn.?-°''K'^ "'*!? ^:^^r^"^« t° ^^^ ^isk drive number! In 
ds, the Setup file chains to the Data file and the file chain will 
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other 

always 

— > 



re-ference the drive -from which the 
Data -file was originally established, 
even though the Setup -file can be 
loaded -from either drive- This can 
spell disaster i-f you lose a disk 
drive or you hoped to demonstrate the 
program on a single-drive system. 

The solution is to sector edit 
the disk, but be-fore you load up your 
sector editor, the edit that is 
required is not a straight— forward 
task! In the Setup -file, the -first 15 

bytes are -for the drive re-ference and 
-filename. Sounds simple, huh? Well, 
you'll discover that there is an 
unusual o-f-fset! As an example, let's 
assume that your Data -filename is 
■■D8K2. FILENAME". All of the values 
you -find in the sector editor are 
decimal 126 above the values you might 
expect. Our example would look like 
this: 



C4 D3 CB B2 AE C6 etc. 

Reducing by decimal 128 
to ASCII, it looks like 



K 



and converting 
this: 



I-f you have di-f-f iculties converting 
heK to decimal or adding and 
subtracting hex values, you might want 
to get a programmer's calculator or 
use the conversion tables available in 
many printer manuals. Anyway, the B2 
in the example can be changed to Bl to 
change the drive number re-ference! Ah, 
it's really simple once you know how! 
Simply change the least signi-ficant 
nibble (second digit) of the hex value 
o-f byte 3 (the -fourth byte) of the 
Setup file to correspond directly to 
the drive number. 



Getting the Most From a 
Graphics Program 



STANDARDS 



lA 2XB or EA or MM or 
3B (o) 4B 5A 6B 7B 9B 
lOB (o) 



TW 



Though many graphics programs 



exist for the 99/4A, our pick as the 

leader is TI-Artist II. The program 

emerges at the top of the pack due not 

only to its own merits, but also from 

the availability of compatible 
software. 

First of all, TI-Artist II will 

load files created by other graphics 

packages, such as Draw-a-Bit, Draw 'n 

Plot*"', and Graphx. This is often 
quite convenient. For instance, we 



find that Draw 'n Plot 



t. m 



not as 



good as some of the other packages for 
drawing, but it does offer easy to use 
plotting routines that are quite 
powerful. Enhancing Draw 'n Plot 
plots from TI-Artist II is ideal for 
many applications. And, Graphx also 
enjoys support from products such as 
Graphx Companion (Asgard) and, again, 
the ability to pass such drawings into 
TI-Artist II is a big plus. 

The most impressive support of 
all is the recent introduction of 
TI-Artist Companion #1, a 5 disk 
package of 25 character fonts, 30 
pictures and 160 5x5 graphics that 
were originally developed for use in 
Character Sets and Graphics Design. 
Developed by Dave Rose, TI-Artist 
Companion #1 is a giant leap forward 
in 99/4A graphics' Using the Slides 
Menu of TI-Artist II, the characters 
and graphics can be easily loaded to 
any area of the screen, then mixed 
with one's own artwork if desired. 
The package works with Okidata 92-93, 
IBM, Epson and compatibles. Axiom 
GP-lOO and C-Itoh Prowriter 8510 and 
compatibles (quite an impressive range 
of printers). The package is 
available for only ♦17-95 from Dave 
Rose, 2781 Resor Road, Fairfield, 
OH 45014-5053. The "#1" label on the 
name seems to imply there will be a 
"#2", which would be more good news. 

TI-Artist II is a program that 
anyone interested in creating graphics 
designs on the 99/4A will surely want 
to have- The program is *19.95 plus 
«1.50 shipping and handling (MD add 5% 
sales tax) from Inscebot, Inc., P.O. 
Box 260, Arnold, MD 21012. 
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News^ Correct! on s<i 

fl Note Froft the Editor 

In order to provide taxiiui coverage 
without raising our prices or 
diiinishing our quality, He have 
introduced neit print foriats ttiis 
lonth. Your coiientf would be 
appreciated. 



F=-OTF>C3LJRR I 

Updates !i Editorials^ Kudos and Come— what— may 



! 



Also, triis iu\it is luch latfr in 
Ding out thin anticipatid dm to 
aiiiy obligations (Hi'rc all back in 

good health pdm). Nork is already 

undir Hay on our next issue. 

Richard Hitchell, Editor 



I KISH I HADi 

F3i For F.J. Bubtnik, Jr., 
Hicksville, NY, the prograi you need 
for duiping graphics and text to your 
ProHriter B510 printer is 'Screen 
Iiage Duip', by Dave Rose, 27B1 Resor 
Road, Fairfield, OH 45014-5053. The 
prograi runs froi either BASIC Nith 
the Editor/Asseibler or Mini Fteiory or 
froi Extended BASIC (instructions 
require E/A, KB or TI-M, send $1 if 
all you have is HH). A screen can be 
duiped at any point in a prograi via a 
CTRL/FCTN key sequence (a kiyscan is 
done at all tiies). The prograi is in 
Asseibly Language for speed. Other 
printers supported are Tl-Iipact, 
Epson FX-RX-NX, Panasonic KXP 
1090-1091, Star Seeini 10-10X-S610, 
BNC BXSO, Tally Spirit 80 and NEC 
8023. The prograi is $16.95 (First 
Class Postage and Handling included). 
Nhen ordering froi Dave Rose, always 
include your full printer inforiation 
(brand, serial or parallel, port 1 or 
2, baud rate for serial). 

N4t 1 Hiih I had either a Fortran or a 
Pascal coipiler (or both). Jaies N. 
Stricherz, College Station, TX. 

F4i Jaiss, TI did produce a P-Codc 
card and software. The card goes in 
the TI Peripheral Expansion Box, Hot 
lany of the cards Mere sold, so deiand 
far exceeds supply for used cards, He 
have heard that soie users have 
iipleientcd a P-Codt virsion of 
Fortran Mritten for PC's, but hi have 
not yet diterilnid ihithir that is a 
ligal iipliientation or exactly hoN it 
Mas accoiplished. The P-Code card has 
its OHH pONir SMitch, but thi card's 
addressing does not periit usi Kith 



the nVAfiC HEXP-1 RAN disk (unless soie 
talented hardware hacker builds a 
bypass). Other cards lay also be 
incoipatible. Also, note that the 
P-Code card runs Marier than other 
cards. Do not reiove the claishell 
case, as that is what provides the 
heatsink for the card (the P.E.6. fan 
does little to cool cards)! If anyani 
has further inforiation for Jaies or 
has a P-Code card for sale at a 
reasonable price, please let us knoM. 



There will be several 99/4A shows this 
spring. i*ord froi flB-99'er5 User 
Group is that the group will host the 
TI netropolitan Area Regional 
Conference of User Groups (TinARC) on 
April 12, 19B6 at Queensborough 
Coeiunity College, 56th Ave. and 
Springfield Blvd., Bayside, NY 11364. 
Groups froi New York and New Jersey 
will participate. The conference will 
start at 1 PH and continue until 6 PK. 
Tutorials will be froi 2 to 5 PFI, with 
products being on view before and 
after the tutorial session, Adiission 
is free upon presentation of 
recognized TI User Group ID («1 to all 
others). Further inforiation can be 
obtained by sending a SASE to Kr, 
Frank Cotty at the college address. 



The Texas Instruients Coiputer 
Fun Festival, T.I,C,0,F,F., 
Harch 15, 1986, at Resell 
School, Roselle, NJ, A flea 
and a nuiber of proiinent 
speakers are on the agenda, 
inquiries are invited, Anyo 
questions should contact Stive 
at (201) 686-5616. 



Owners 
will be 
e High 

larket 
guest 

Vendor 
ne with 

Citron 



News froi the 99' Fest-Nest '86 show 
in Los Angeles is thit a iijor new 
hardware product will be on display. 
The LA show will be Harch 1 and 2 at 
the Shrine Auditoriui in Los Angilis. 



Pilgriis' Pride, i lajor 

ntallir, his Mvid to 3 Nilli 

Hatboro, PA 19040. Phone 
441-4262. 



99/4A 

Li., 

(213) 
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Please! Notify us if your address 
changes! U.S. Third Class Nail cannot 
be forwarded! Avoid long delays in 
getting your issues by notifying us 
proiptly of your new address! 



Asgard Software has bicoie the first 
99/4A fin to offer products on the 
Electronic Mall section of CIS. To 
place on-line orders, GO TDG. 



The popular teriinal eiulator prograi 
4A/Talk is now available through 
Triton, according to the fin's Fall 
'65 catalog. Triton's address is P.O. 
Box B123, San Francisco, CA 94128. 



Navaroni Industries has changed 
ownership and loved to Dallas, TX. 
Chuck Huiphries, a long-tiie key 
eiployee, reiains with the fin. The 
new phone nuiber is (214) 941-1B16. 



Mell, we've finally received reports 
froi persons outside of HVARC who have 
seen Extended BASIC II. The package 
was unveiled at the CES in Las Vegas, 
but will likely not be in the hands of 
the buying public for at least another 
lonth. The package is said to be 
iipresiive, 



A new coiiunications network in Canada 
is gaining the support of lany 
individuals and Canadian User Groups. 
TIMELINE is available at »30 Canadian 
or 125 U.S. sign-up fee. Connect 
till rates scei to be fairly 
reasonable. The syitei supports up to 
24 users who can teleconference. A 
U.S. toll-free nuibir is available 
(the surcharge to cover this service 
is far below what the long distance 
charge would be) . For further 
inforiation, contact T.U.G., 6S0 - 
100th Ave., Laval, Quebec, Canada 
K7N-3Z6 or call (514) 681-22B0, This 
inforiation was provided by Raynald 
Hakinen, who asks that you lention his 
user ID, RAVNALD.A1464 when signing up 
for the service. 
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OTHER 
Check or Money Order 
coded -for 



$16.00 
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through the 
Bank System. 
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STANDARD KEY i 

1 


1 


Computer 


A 


TI-99/4A ! 


2 


Module 


XB 


Extended BASIC 1 






TW 


Tl-Writer 1 






EA 


Edit or /Assembler 1 






MM 


Mini Memory . ! 
Navarone DBM ! 






DB 


3 


RS-232 


B 


TI 1 


4 


Disk Drive 


B 


TEAC 55-B 1 


5 


Expansion Box 


A 


TI ! 


6 


Disk 
Control ler 


B 


Cor Com p ! 


7 


Memory Card 


B 


MYARC MEXP-1 ! 
<128K) 
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Monitor or TV 
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TI Color Monitor 1 


10 


Printer 


B 


Gemini 15-X 1 


15 


GRAM device 
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GRAM Kracker (tm> 1 



o-f Millers Graphics 
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